DitherLine(byte[],int,byte[],int) Method

Summary

Used in a loop, dithers the line in a specified input buffer, and writes it to an output buffer.

Syntax

Objective-C

C++/CLI

Java

Python

public void DitherLine( 
   byte[] srcBuffer, 
   int srcBufferOffset, 
   byte[] destBuffer, 
   int destBufferOffset 
)

- (BOOL)ditherLine:(const unsigned char *)srcBuffer  
        destBuffer:(unsigned char *)dstBuffer  
             error:(NSError **)error

public void ditherLine( 
   byte[] byte[Value,  
   int intValue,  
   byte[] byte[Value2,  
   int intValue2 
);

public: 
void DitherLine(  
   array<byte>^ srcBuffer, 
   int srcBufferOffset, 
   array<byte>^ destBuffer, 
   int destBufferOffset 
)

def DitherLine(self,srcBuffer,srcBufferOffset,destBuffer,destBufferOffset):

Parameters

srcBuffer
The input buffer.

srcBufferOffset
Index to srcBuffer where the source data is started.

destBuffer
The output buffer.

destBufferOffset
Index to destBuffer where the destination data is started.

Remarks

This method uses the dithering method specified in the DitheringMethod property. Therefore, it provides better 4-bit or 8-bit output than the RasterBufferConverter.Convert method.

This method uses the palette that the StartDithering method specifies. The output of the DitherLine method is made up of 1-bit, 4-bit, or 8-bit indexes to the specified palette. StopDithering cleans up the allocated variables and buffers. For a description of how the methods relate to each other, refer to the StartDithering.

This method does not support signed images.

For more information, refer to Introduction to Image Processing With LEADTOOLS.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Dicom; 
using Leadtools.Drawing; 
using Leadtools.Controls; 
using Leadtools.Svg; 
 
 
public void StartDitheringExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
   // Load an image that has BottomLeft ViewPerspective 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")); 
 
   RasterColor[] Palette = RasterPalette.Fixed(256); 
 
   // Create the new palletized image. 
   RasterImage destinationImage = new RasterImage(RasterMemoryFlags.Conventional, image.Width, image.Height, 8, image.Order, image.ViewPerspective, Palette, IntPtr.Zero, 0); 
 
   // Set the dithering method. 
   image.DitheringMethod = RasterDitheringMethod.StevensonArce; 
 
   // Initialize the dithering process. 
   image.StartDithering(Palette, 256); 
 
   // Allocate the output buffer for 8-bit data. 
   byte[] InBuffer = new byte[image.Width * 3];// Buffer to hold the input row. 
   byte[] OutBuffer = new byte[image.Width];// Buffer to hold the output row. 
 
   // Use DitherLine method to process each row in the image. 
   image.Access(); 
   destinationImage.Access(); 
   for (int i = 0; i < image.Height; i++) 
   { 
      image.GetRow(i, InBuffer, 0, image.BytesPerLine); 
      image.DitherLine(InBuffer, 0, OutBuffer, 0); 
      destinationImage.SetRow(i, OutBuffer, 0, destinationImage.BytesPerLine); 
   } 
   destinationImage.Release(); 
   image.Release(); 
 
   // End the dithering process. 
   image.StopDithering(); 
 
   codecs.Save(destinationImage, Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_DitherLine.BMP"), RasterImageFormat.Bmp, 0); 
 
   image.Dispose(); 
   destinationImage.Dispose(); 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}